home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Scope / Scope Disk #017 (199x)(Scope PD)(US)[WB].zip / Scope Disk #017 (199x)(Scope PD)(US)[WB].adf / QMouse1.0 / QMouse.doc < prev    next >
Text File  |  1988-06-29  |  6KB  |  130 lines
  1.                            QMouse 1.0  by Lyman Epp
  2.  
  3.         Another "Mouse Accelerator???"  What for?  It seems that all the
  4.         other mouse accelerators have been written in "C".  This is okay,
  5.         but the programs are 10-20K.  This mouse accelerator is written
  6.         in assembler and contains most of the features of the others, but
  7.         the program size is less than 3K bytes!  Also, the source is
  8.         included so that you can add more features (please send me a copy
  9.         if you do.)  QMouse stands for "Quick Mouse."
  10.  
  11.         This is being distributed as ShareWare.  If you think that QMouse
  12.         is useful, please send $10.  If you don't think that it is useful,
  13.         then why are you using it?  Your response will insure the release
  14.         of more quality programs for your Amiga!  Programs already in the
  15.         works include: a disk based print spooler, a window dump that
  16.         converts the window bitmap back to text, a file viewer, and more.
  17.  
  18.                 Lyman R. Epp
  19.                 10072 Wirt Plaza #15
  20.                 Omaha, Nebraska 68134
  21.  
  22.  
  23.  
  24.         - Any option can be turned off or modified.
  25.  
  26.         - Screen blanks if keyboard or mouse is idle for a while.
  27.  
  28.         - The Mouse Pointer blanks if mouse is idle for a while.
  29.  
  30.         - Mouse Accelerator with configurable threshold to allow precise
  31.           mouse positioning.
  32.  
  33.         - Configurable command string ala PopCli, default left-AMIGA-ESC.
  34.  
  35.         - Left Mouse Button click in window brings it to the front
  36.             Does not bring the window to the front if it is already
  37.             in the front.  Other programs would call WindowToFront() on
  38.             every click, which is nasty if you have a simple refresh
  39.             window.  The number of clicks required is configurable.
  40.  
  41.         - The smallest clock yet!  Can be turned off if you don't like
  42.           clocks.  Starting column is also configurable.  The clock
  43.           window will be brought to the front (of the WorkBench screen)
  44.           every 10 seconds.
  45.  
  46.         - Uses a background CLI.  Programs like DMouse and PopCLI3 don't
  47.           use a background CLI, and therefore any NewCLI's spawned by
  48.           them will have no default directory, no default path, etc.
  49.           Using a background CLI simply requires that you use RunBack
  50.           (included) instead of Run (to allow closing the initial CLI.)
  51.  
  52.  
  53. EXECUTE FROM A CLI (e.g. WorkBench Startup-Sequence), example:
  54.  
  55.     1> RunBack QMouse -c543 "-eNewCLI con:0/0/640/150/AmigaDOS"
  56.  
  57.  
  58. TO KILL:
  59.  
  60.     Press CTRL-AMIGA-ESC (all at the same time.)
  61.  
  62.  
  63. SOURCE:
  64.  
  65.     Source must be assembled under Metacomco assembler.
  66.  
  67.  
  68. COMMAND LINE ARGUMENTS:
  69.  
  70.     Arguments can be typed in upper or lower case.  Arguments can be enclosed
  71.     in quotes, e.g. "-a3" or "-eNewCLI con:0/0/640/200"
  72.  
  73.     -a#         Set acceleration to #.  Can be in the range of 0 to 65535.
  74.                 Mouse movement events that have X or Y motion greater
  75.                 than the Acceleration threshold (see option -t) will be
  76.                 accelerated by this factor.  The default is 3.  To disable
  77.                 this feature, specify 0 or 1.
  78.  
  79.     -c#         Activate clock.  You can also specify an optional column
  80.                 where the clock will be displayed.  The column number must
  81.                 be in the range of 0 to (Screen Width - 44).  The width of
  82.                 the clock is 44 pixels.  To place the clock next to the
  83.                 front/back gadgets, use a value of (Screen Width - 44 - 53).
  84.                 With a screen width of 640, this would be a column value of
  85.                 543 (-c543).  The default column is 280.
  86.  
  87.     -eCOMMAND   Set Command to run.  If the command contains spaces, then
  88.                 the entire command must be enclosed in quotes.  This feature
  89.                 can be placed anywhere on the command line.  The default
  90.                 command is "NewCLI".
  91.  
  92.     -k#         Set number of clicks required to bring a window to front.
  93.                 Will not call WindowToFront() if the window is already the
  94.                 front window.  The default is 2 clicks.  To disable this
  95.                 feature, specify 0 clicks.  Can be in the range of 0 to
  96.                 65535 clicks.
  97.  
  98.     -m          Activate AMIGA-M to send front screen to back.
  99.  
  100.     -p#         Set the number of seconds to wait after a mouse event before
  101.                 making the mouse pointer invisible.  Gets the mouse pointer
  102.                 out of your way!  Just move the mouse again and the pointer
  103.                 will reappear.  The default is 10 seconds.  To disable this
  104.                 feature, specify 0 seconds.  Can be in the range of 0 to
  105.                 65535 seconds.
  106.  
  107.     -s#         Set the number of seconds to wait after any event (keyboard,
  108.                 mouse or disk changed) before blanking the screen.  Keeps
  109.                 an image from "burning in" to your monitor.  Just move the
  110.                 mouse, type a key or insert a disk and the screen will be
  111.                 restored.  The default is 600 seconds.  To disable this
  112.                 feature, specify 0 seconds.  Can be in the range of 0 to
  113.                 65535 seconds.
  114.  
  115.     -t#         Set mouse acceleration threshold in pixels per event.  Any
  116.                 mouse movement events that have X or Y motion greater than
  117.                 this number will be accelerated by the acceleration factor
  118.                 (see option -a).  This option provides a way to position
  119.                 the mouse pointer precisely, without the acceleration
  120.                 factor "getting in the way."  The default is 3.  Can be in
  121.                 the range of 0 to 32767 pixels per event.
  122.  
  123.  
  124. CREDITS
  125.  
  126.     This program has been inspired by PopCLI, Mach, DMouse, MouseOff and
  127.     others.  Thanks to the authors of these programs for providing good
  128.     examples of how to make the Amiga "do its thing!"
  129.  
  130.